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Clock Widget 


The clock widget displays the current time in a given time zone, using an analog clock face. 


Creating a Clock 


A clock widget can be created by dragging it out from the Tools Palette, where it appears with the following icon: 


create widget as "com.livecode.widget.clock" 


Alternatively it can be created in script using: 


Clock Display 


The clock has two different styles, depending on whether it is day or night. By default the hands are dark on a light 
background when displaying a time at night (between 8PM and 6AM), and the hands are light on a dark background 
when displaying a time during the day. 
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These colors can be customised using 


the dayNumberColor , dayHourHandColor , dayMinuteHandColor , daySecondHandColor and dayFaceColor properties, 
and the equivalent properties for night. 


The read-only property isDay also reflects whether the current time is AM or PM. 


The time displayed by the clock can differ from the current system local time by setting the timeZone property, an integer 
which adjusts the time displayed relative to universal time (UTC). For instance, to set the clock to display a time that is 6 
hours ahead of UCT time ("+06:00"): 


set the timeZone of widget "Clock" to 21600 





as 21600 seconds is 6 hours. 
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